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[REV | REVISION 
LTR |ISSUE DATE 


A | 1/23/75 Fede. ORIGINAL ISSUE 


APeROVEe BY REVISIONS 


B | 1/20/76 Cas’) MAJOR REVISION: Supports restructuring of MARK V.1 
—_ | me / Basic Compiler | 
LS | 6/10/77) py, AA MARK V1.1 CHANGES: 
| , , i J—1 Red evences to B1700 changed to B1800/B1700° 
/ | j—1 | Statement maximum length changed from Sr erty to. 
243 characters 
1-3 | _ . Memory requirements % 8K bytes of meEnOry changed 
| to LOK | | 
2-1 to 2-3 All references to INTRN2 Saanued to INTRN3. 
| Added BAS. INTRN3/#MRM, “BAS. INTRN3/#RDM, 
BAS. INTRN3/#WRM, BAS. INTRN3/#WRT 
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SMALL SYSTEMS GROUP © —-s«B1800/B1700 BASIC COMPILER © 
SANTA BARBARA PLANT P.Se. 2212 5280 REV C 
GENERAL 


The B1i800/81700 SASIC Compiler program generates» from valid 


BASIC source statements» object code files and Swinstructions | 


that can be processed by the BASIC itnterpreter. After a orief 
preliminary discussion of the compiter'ts node of operations this 
product specification discusses the essential operating 
requirements of the compiler: file structure» wmnemory size» 
$-card optionss and intrinsics. | - 7 


Legitimate statements in S8ASIC are defined in the Burroughs 
publication: Burroughs Standard BASIC (55G). A BASIC statement 
consists of a tine number followed by a verb fotlowed by the. 
remainder of the statements Qedes 100 LET A =B+t+ Ce. The 
statement begins in column one and its naxinun length is 243 
characters. Code files are discussed» in general» in the product 


specifications for MCPI and MCPII, and BASIC S-instructions are 
described in product specification #2219 01355 81800/B1700 BASIC - _ 
S*language. | — a er er 


RELATED PUBLICATIONS 


NAME - _ NUMBER 


Burroughs BASIC Language Standard (CSG) 1955 2783 
B1800/81700 BASIC 3~Language PeSe 2210 0135 
MCPII — PAS) 2212 5462 


Software Operational Guide | 1968731 
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STRATEGY OF COMPILATION 


After performing the necessary initialization of various. tables 
and variables» the compiler enters a loop that processes all of. 
the source statements in the input file in three procedure calls. 
The first procedure reads the statements and associates the line 
numbers and their current locations in the object code by pushing 
both their vatues into a stack. If the list option is on and 
compilation was not initiated from a remote terminals the 
Statement and the current location in the odject code is printed. 
The second procedure gets the verb Cor keyword) that introduces 
the statement. The third procedure contains a set of procedure 


calls» one for each of the possible BASIC statements. 


When the Last source statement has been processed». some cleantup 


works, 8ege5 filling in unresolved branch addresses and checking 


for unfinished function definitions and far-loopss is done. I f 
there were no compilation errors» a code file is buiit. The code. 
file contains the Program Parameter Block» Run Structures and the 
other features that the MCP requires to run the programe The 
code file is written onto disk and compilation terminates. If 
there were compilation errors» no code file is built. 


ERROR CONDITIONS 


The list of error conditions and associated messages are found in 
the Burroughs BASIC Language Standard. 
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COMPILER EILES 
During compilations the following three files are used: 


INTERNAL | EXTERNAL 


FILE NAME FILE IDENTIFIER USE 
CARDS CARDS | Source statements | 
LINE LINES 3 Qutput tisting — 
CODE | | 7 CODE | Compiled s*code 
MEMORY REQUIREMENTS 


In its released versions the. compiter requires 10K bytes of es oe 


memorye 


PERFORMANCE 


The performance of BASIC object programs which use arrays or 


character string manipulation and which run with the state light 


on can usually be improved greatly by increasing the amount of 
dynamic memory available for these arrays or strings. The 
optimum amount of memory varies depending on the size of the 
program, the other jobs in the mix» and the anount of aGROEY: on 
the system on which the program is a 


DOLLAR-SIGN CONTROL CARDS” 


The compiler recognizes the following $=card options» entered 


An4 
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after the line nunber and separated oy a space. The $=sign 


itself must precede the options and be separated from them by a - 
a 


space. For example, the correct format to request 
Single-spaced listing of the source statements only would be: 
1000 $ NO CODE LIST SINGLE 


Compiler options are as follows: 


OPTION DEFAULT USE 


CARD ON | Documentation only. 

LIST | ON | Output listing > | 

SINGLE ON : Single-spaced output ising: 

DOUBLE  oOOFF Double-spaced output Listing. 

CODE OFF Qutput compited S-code — 
NO OFF | Turns off option which follows a 
‘STRINGSPACE B | Numoer of data pages available for 


string concatenations input» and 


other operations which generate new 


strings. A string space data page 
. | hotds 512 characters. | 
STACK | 100 Number of words available for the 


numeric/string stack. The word size. 


is 48 bits. 
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OBJECT PROGRAM FILES 


During executions one or more files are used as required by the 
program (eeg.» the print file is always present). Compiler file 
names are: | | 7 


INTERNAL EXTERNAL 
FILE NAME FILE IDENTIFIER : USE 


PRINT «PRINT - Qutput from print-statement _ 
INPUT INPUT Inout to input-statement | 
FILEO1 AS DECLARED | Disk File | 
FILEOQ2 AS DECLARED Disk file 
te x x 

* t * 

~~ a, | ® | | , 
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INIRINSICS © 


During executions the following intrinsics can be called by the | 


P.S. 2212 5280 REV C 


program to perform input» outputs and mathematical functions: 


BAS» INTRN3/#CAT 


BAS~INTRN3/#CON 


BAS es INT RNS/#DCT 


BAS»INTRN3/#EDS 


BAS «INTRN3/#ERR 
BAS. INTRN3/#EXP 
BAS INTRN3/HEVI 
BAS INTRN3/EFAP 
BAS. INTRN3/4FBS 


BAS .INTRN3/#FDE 


BASeINTRNS/#FEM 


BASeINTRN3/S#EEMA 


BASINTRNS/#FMT 


BAS. INTRN3/#FOC 
BAS. INTRN3/#FRE 
BAS. INTRN3/#FSC 
BAS eINTRN3/#FUN 


BAS »INIRN3/#IDN 


Concatenate two strings. 


Constant one. Generates a numeric array» 


all elements are one. | . a 


Dates clock and time. Called at the 
peginning of execution to get the start 
time. Also implements the functions 
DATS» CLKS» TIM» CHRS» IDA» and BCL. 


End of job. Cailed at the end of 


execution. Also implements the. 


Statements STOP» END» and CHAIN. 
Error. Handles execution errors. 
Antilogarithm (3ase e). 


Evaluates image. 


File append. 


File backspace. 


File delimit. 


If end file and if more file. 
File margin. 


Format numeric and string output 


according to the associated image. 


File open and close. 
File restore. 


File scratch. 


File functions HPS» LIN» and VPS. 


Identity. Generates an identity matrix. | 


at 
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BAS INTRN3/#INT Greatest inbaget function. 
BAS. INTRN3/#INV Invert a matrix. | | 
| BAS.INTRN3/#I0B Input*"output begin. Initiates all 1/0 
Statements. | | 
BASeINTRN3/ALOG Natural togarithm (Base e). | 
BAS. INTRN3/#MAD- Matrix add. 
BAS» INTRN3/#MAS Matrix assignment. 
BAS. INTRN3/#MMY Matrix aututnly. 
BAS. INTRN3/#MOD MOD function. 
BAS « INTRN3/#MRI Matrix read and input. | 
| BAS. INTRN3/@MRM Matrix read a memory image file. — 
| BASsINTRN3/#MSB Matrix subtract. 
BASeINTRN3/4¢MSM Matrix scalar multiply. 
: BASs»INTRN3/#NUL Null. Generates a string aCLays alt of 
whose elements are null. 
BASs~INIRN3/#PRM Print a numeric or shee aar uae a: 
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BAS. INTRN3/#PRT 


BAS. INTRN3/#PHR 


BASe~INTRN3/ARDM 


BAS.INTRN3/#REP 


BASsINTRN3/#RIA 


Implements MAT PRINT and MAT = WRITE 
statements. | 


Print a numeric or string value. 
Implements PRINT and WRITE statements and 
the TAB function. 


Power routine (X«*Y). 


Read a memory image file. | 


Reptace. Implements the REPS function. 


read or input a numeric or string vatue. 


BASe«INTRNS/S#RND Random number generator. 
BAS. INTRNS/#RNI Random number initializer. 
BAS. INTRN3/#SCN 


Scan. Implements the SCN function. 
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BAS.~INTRN3/#SGN 
BAS. INTRN3/#SOR 
BAS. INTRN3/#STR 


BASSINTRN3/#TRG 


BASw~INTRN3/&#TRM 


BAS. INTRN3/#TRN 
BAS. INTRN3/#VAL. 


BAS INTRN3/#WRM 


BAS. LNTRN3/#URT 


BAS» INTRN3/#ZER 


2-3 


COMPANY CONFIDENTIAL 
81800/81700 BASIC COMPILER 


PaS. 2212 5289 REV C 


Sign function. 
Square root. 


String. Implements the STR$ function. 


Trig routines. | Implements the SIN» COS» 


TAN» COT» and ATN functions. 


Trim an array. Implements trimmers in 


MAT statements. 


Transpose an array. 


Value. Implements the VAL function. 


Write a numeric or string array to a 
memory image file. | 


Write ao numeric or string value to a 
memory image file. Pa ee 7 


Zerode Generates a numeric array, all of 
whose eronenes are zero. 
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